Skip to content

refactor(create-expert): convert procedural instructions to declarative domain knowledge#386

Merged
FL4TLiN3 merged 2 commits intomainfrom
refactor/376-declarative-instructions
Jan 3, 2026
Merged

refactor(create-expert): convert procedural instructions to declarative domain knowledge#386
FL4TLiN3 merged 2 commits intomainfrom
refactor/376-declarative-instructions

Conversation

@FL4TLiN3
Copy link
Contributor

@FL4TLiN3 FL4TLiN3 commented Jan 3, 2026

Summary

Converts procedural step-by-step instructions in create-expert's internal experts to declarative domain knowledge, aligning with Best Practice #2 "Trust the LLM, Define Domain Knowledge".

Changes

  • CREATE_EXPERT_INSTRUCTION: Replace numbered workflow steps with delegate descriptions and context passing guidance
  • INTEGRATION_MANAGER_INSTRUCTION: Replace numbered workflow with role description and responsibilities
  • EXPERT_TESTER_INSTRUCTION: Replace step-by-step testing process with domain knowledge sections

Before (procedural)

## Workflow
1. **Extract Properties**: Delegate to `property-extractor`...
2. **Build Expert Ecosystem**: Delegate to `ecosystem-builder`...
3. **Integration Testing**: Delegate to `integration-manager`...

After (declarative)

## Delegates
- `property-extractor`: Analyzes requirements and identifies testable properties
- `ecosystem-builder`: Creates the Expert ecosystem (main, demo, setup, doctor)
- `integration-manager`: Coordinates all testing and quality assessment

## Context Passing
Include relevant context when delegating...

Closes #376

Test plan

  • CI passes
  • No behavior changes expected (instructions refactored, not logic)

Note

Refactors instruction text to be declarative and policy-driven across the create-expert ecosystem.

  • Updates CREATE_EXPERT_INSTRUCTION with delegate roles, context passing, quality standards, and architecture
  • Revises INTEGRATION_MANAGER_INSTRUCTION to describe parallel delegation, trade-off analysis, integration verification, and scoring with a defined report format
  • Reworks EXPERT_TESTER_INSTRUCTION to emphasize black-box exec testing, parallel test execution, stage-specific domain knowledge, and clear evaluation criteria
  • Keeps FUNCTIONAL_MANAGER_INSTRUCTION and USABILITY_MANAGER_INSTRUCTION aligned with declarative testing categories and outputs
  • Changes limited to instruction strings in apps/create-expert/src/lib/create-expert-toml.ts plus a patch changeset; no runtime or logic modifications

Written by Cursor Bugbot for commit 9613e35. This will update automatically on new commits. Configure here.

…ve domain knowledge

- CREATE_EXPERT_INSTRUCTION: Replace numbered workflow steps with delegate descriptions and context passing guidance
- INTEGRATION_MANAGER_INSTRUCTION: Replace numbered workflow with role description and responsibilities
- EXPERT_TESTER_INSTRUCTION: Replace step-by-step testing process with domain knowledge sections

This aligns with Best Practice #2 "Trust the LLM, Define Domain Knowledge" by:
- Defining what each expert knows and can do, not how to do it step-by-step
- Trusting the LLM to figure out the execution details
- Keeping instructions declarative (policies not procedures)

Closes #376

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Jan 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@FL4TLiN3 FL4TLiN3 merged commit cfbe65b into main Jan 3, 2026
7 checks passed
@FL4TLiN3 FL4TLiN3 deleted the refactor/376-declarative-instructions branch January 3, 2026 07:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refactor: convert procedural instructions to declarative domain knowledge in create-expert experts

1 participant